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CHAPTER 1 
I/O SUBSYSTEM HARDWARE OVERVIEW 



INPUT/OUTPUT SUBSYSTEM 

INCREASES CRAY-1 S CPU THROUGHPUT BY REDUCING ITS I/O AND 
FRONT-END RESPONSIBILITIES. 



STREAMS DATA TO CENTRAL MEMORY OVER AN 810 MBIT/S CHANNEL, ' 

PROVIDES ACCESS TO ADDITIONAL PERIPHERALS. (TAPES) 

FUNCTIONS AS A MAINTENANCE CONTROL UNIT. 

DRIVES UP TO 48 DD-29 DISK DRIVES FOR MASS STORAGE. 

ALLOWS OPERATOR CONTROL OF COS. 

COLLECTS AND CONCENTRATES DATA FROM FRONT-ENDS. 

PROVIDES FOR JOB AND DATA ENTRY. 

DISTRIBUTES CPU OUTPUT TO SLOWER PERIPHERAL EXPANDER DEVICES. 

CONSISTS OF TWO TO FOUR I/O PROCESSORS WITH A SHARED BUFFER MEMORY. 
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INDIVIDUAL I/O PROCESSOR 

LOCAL MEMORY: 

65,536 WORDS 
16 BITS/WORD 
2.43 GIGABIT BAND WIDTH 

COMPUTATION SECTION: 

INSTRUCTION CONTROL NETWORK 

2 FUNCTIONAL UNITS (ADDER AND SHIFTER) 

LOGICAL 'AND' OPERATION 

512 OPERAND REGISTERS 

1 PROGRAMMER-VISIBLE ACCUMULATOR 

SINGLE ADDRESS MODE 

76 MEGAHZ CYCLE TIME 



I/O SECTION: 



6 DIRECT MEMORY ACCESS (DMA) PORTS 

810 MEGABIT/S MAXIMUM TRANSFER RATE PER PORT 

SEVERAL CHANNELS MAY MULTIPLEX INTO ONE PORT 
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MODEL NUMBERING CONVENTION 



CRAY- 1 S/1200 THROUGH /4400 CONTAIN AN I/O SUBSYSTEM 



FIRST DIGIT INDICATES SIZE OF CENTRAL MEMORY IN MEGAWORDS 



SECOND DIGIT INDICATES NUMBER OF I/O PROCESSORS 
EXAMPLE: 



CRAY-1 S/2300 HAS 2 MILLION WORDS 

OF CENTRAL MEMORY AND 3 I/O PROCESSORS. 
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CRAY-1 S/X300 

THREE PROCESSOR SYSTEM 

1, MASTER I/O PROCESSOR (MIOP) 

CONTROLS FRONT END- INTERFACES. 

HAS THREE DISPLAY CONSOLES. 

HAS AN EXPANDER CHANNEL WHICH MULTIPLEXES A PRINTER 
AND A MAG TAPE UNIT. 

CONNECTS TO BUFFER MEMORY THROUGH A DMA CHANNEL. 

EXCHANGES CONTROL SIGNALS WITH CPU OVER A LOW-SPEED 
CRAY-1 S CHANNEL PAIR. 

COMMUNICATES WITH OTHER IOPs OVER ACCUMULATOR CHANNELS. 

MAINTAINS SYSTEM INFORMATION ERROR LOG. 

COORDINATES ACTIONS OF CPU AND OTHER IOPs. 

2. BUFFER I/O PROCESSOR (BIOP) 

HANDLES DATA TRANSFERS BETWEEN CPU AND I/O SUBSYSTEM 

CONNECTS DIRECTLY TO CENTRAL MEMORY. 

CONNECTS TO BUFFER MEMORY THROUGH A DMA CHANNEL. 

COMMUNICATES WITH OTHER IOPs OVER ACCUMULATOR CHANNELS. 

DRIVES UP TO 16 DD-29 DISK DRIVES. 
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3. BLOCK MULTIPLEXER I/O PROCESSOR (XIOP) 

CONNECTS TO BUFFER MEMORY THROUGH A DMA CHANNEL. 
COMMUNICATES WITH OTHER IOPs OVER ACCUMULATOR CHANNELS 
HANDLES 1 TO 16 BLOCK MUX (IBM COMPATIBLE) CHANNELS, 
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1 TO 16 
DD-29 
DISK UNITS 



1 TO 16 
CHANNELS 



EXTERNAL CHANNEL 

= 810 Mbits/s DMA CHANNEL 

urn 50 Mbits/s CRAY-1 S CHANNEL PAIR 
ACCUMULATOR CHANNEL 

um ■ 810 Mbits/s MEMDRY CHANNEL 



FIGURE 1-2 Block Diagram of S/1300, S/2300 and S/4300 Systems 
with Block Multiplexer Channels. 
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CHAPTER 2 
OPERATING SYSTEM OVERVIEW 



FUNCTIONS 



PERFORMS I/O BETWEEN CPU AND PERIPHERALS 



MANAGES FRONT- END COMMUNICATIONS 



PERFORMS STATION FUNCTIONS 



DEADSTARTS CPU 
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CHARACTERISTICS 



MULTI-TASKING 

UP TO 32 TASKS ACTIVE AT A TIME 



NONPRE-EMPTIVE SCHEDULING 



SIMPLE 16 LEVEL TASK PRIORITY SCHEME 



INTERRUPT DRIVEN 



EXTENSIVE USE OF OVERLAYS 
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SYSTEM COMPONENTS 

KERNEL 

NUCLEUS OF OPERATING SYSTEM. 

LOCAL MEMORY RESIDENT. 

EXECUTES IN EACH I/O PROCESSOR WITH MINOR MODIFICATIONS. 

RESPONSIBLE FOR: 

ACTIVITY MANAGEMENT 

INTER-ACTIVITY COMMUNICATION 

RESOURCE MANAGEMENT 

INTERRUPT HANDLING 

INTER-PROCESSOR COMMUNICATION 

OVERLAYS 

RESIDE IN BUFFER MEMORY. 
READ INTO LOCAL MEMORY WHEN NEEDED. 
MAKE UP THE BULK OF THE SYSTEM. 
NOT ALL USED BY ANY ONE PROCESSOR. 

DISK SUBSYSTEM 

RESIDES MOSTLY IN BUFFER MEMORY AS OVERLAYS. 
EXECUTES IN BIOP OR DIOP. 

STATION SUBSYSTEM 

RESIDES IN BUFFER MEMORY AS OVERLAYS. 
EXECUTES MOSTLY IN MI OP. 

CONCENTRATOR SUBSYSTEM 

RESIDES IN BUFFER MEMORY AS OVERLAYS. 
EXECUTES MOSTLY IN MI OP. 

INTERACTIVE CONCENTRATOR SUBSYSTEM 

RESIDES IN BUFFER MEMORY AS OVERLAYS. 
EXECUTES MOSTLY IN MI OP. 

TAPE SUBSYSTEM 

RESIDES IN BUFFER MEMORY AS OVERLAYS. 
EXECUTES IN XIOP. 
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MIOP 



KERNEL 



CQNCENIRATQB _ _ 

SJALION 

INTERACTIVE' CONC, 



BIOP 



KERNEL 



DLSKJUBSYSTEM I 

STAT., CONCi, INTER. : 



DIOP 



TAPE SUBSYSTEM 



BUFFER 
MEMORY 



OVERLAYS: : 

- DISK SUBSYSTEM 
-- CONCENTRATOR 

- STATION 

-- INTERACTIVE 
CONCENTRATOR 

- TAPE SUBSYSTEM 




FIGURE 2-1 



I OS SOFTWARE CONFIGURATION 
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KERNEL CONSOLE CALLABLE OVERLAYS 



CERTAIN OVERLAY ACTIVITIES MAY BE CREATED BY KEYING IN OVERLAY 
NAME AT KERNEL CONSOLE. 



KERNEL CREATES ACTIVITY FOR THE OVERLAY AND PUTS IT ON IOP 
CENTRAL PROCESSOR QUEUE. 



ACTIVITY THEN PROCEEDS AS ANY OTHER ACTIVITY. 



OPERATOR MAY USE THIS FACILITY TO: 

DEADSTART CPU 

BRING UP THE STATION 

START A CONCENTRATOR 

ENTER THE INTERACTIVE CONCENTRATOR 

RUN TEST ROUTINES 
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IPS STATION 
FUNCTIONS 

PROVIDES A MEANS FOR OPERATOR-CPU COMMUNICATION. 
CONTROLS OPERATOR CONSOLES 



MAY BE USED AS A BATCH JOB ENTRY STATION 

JOBS OR DATASETS STAGED FROM TAPE 



MAY ACCEPT CPU OUTPUT AND DISTRIBUTE IT TO MAG TAPE OR PRINTER 



ALLOWS ON-LINE DEBUGGING OF CPU 
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CHARACTERISTICS 



RESIDES IN BUFFER MEMORY AS OVERLAYS, 



EXECUTES MOSTLY IN MIOP WITH SOME HIGH SPEED TRANSFERS THROUGH BIOP. 



MAY HAVE MORE THAN ONE STATION ACTIVE AT A TIME, 

EACH STATION MUST HAVE A DEDICATED CONSOLE. 
THEY MUST SHARE THE EXPANDER PERIPHERALS. 
TWO OR MORE CONSOLES MAY BE SUPPORTED BY ONE 
STATION. 



COMMUNICATES WITH CPU IN STANDARD CRAY MESSAGE FORMAT, 

APPEARS TO BE JUST ANOTHER FRONT-END STATION TO CPU. 



OPERATOR COMMANDS VIRTUALLY IDENTICAL TO THOSE OF THE PRESENT 
DATA GENERAL ECLIPSE STATION. 
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OVERVIEW OF STATION MESSAGE FLOW 

1. OPERATOR INITIATES A STATION COMMAND. 

2. MIOP BUILDS A MESSAGE. 

3. MIOP WRITES THIS MESSAGE TO BUFFER MEMORY. 

4. BIOP SENDS THE MESSAGE TO CENTRAL MEMORY. 

5. MIOP TELLS CPU MESSAGE IS IN CENTRAL MEMORY. 

6. CPU PROCESSES MESSAGE AND BUILDS A RESPONSE. 

7. BIOP READS RESPONSE MESSAGE AND PUTS IT IN BUFFER MEMORY. 

8. MIOP READS RESPONSE MESSAGE IN FROM BUFFER MEMORY. 

9. IF APPROPRIATE, CONSOLE IS UPDATED WITH NEW INFORMATION. 
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CONCENTRATOR 



FUNCTIONS 



ALLOWS APPARENT DIRECT COMMUNICATION BETWEEN THE CPU AND 
A FRONT-END. 

LOOKS LIKE A CRAY-1 S CHANNEL PAIR TO FRONT-END. 

THUS NO CHANGES NECESSARY TO EXISTING 
FRONT-END STATIONS. 



MAY REDUCE THE NUMBER OF INTERRUPTS TO THE CPU PER FRONT-END 
MESSAGE. 



WILL REDUCE CENTRAL MEMORY MESSAGE SEGMENT BUFFERS WHEN BACK 
DOOR TO DISK IS AVAILABLE. 
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CHARACTERISTICS 



RESIDES IN BUFFER MEMORY AS OVERLAYS. 



EXECUTES MOSTLY IN MIOP WITH HIGH SPEED TRANSFERS TO CPU 
THROUGH BIOP, 



ONE ACTIVE CONCENTRATOR FOR EACH FRONT-END CHANNEL PAIR. 

MAY HAVE SEVERAL LOGICAL ID'S LOGGED ON TO ONE 
CONCENTRATOR. 

EACH ID MAY HAVE A DIFFERENT SEGMENT SIZE. 



CONTROLLED VIA CONC AND ENDCONC KERNEL CONSOLE COMMANDS. 
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CHAPTER 3 
KERNEL CONSOLE COMMANDS 



THE FOLLOWING OPERATOR COMMANDS PERFORM NON-STATION FUNCTIONS. 

THESE ARE ENTERED AT THE KERNEL CONSOLE OF AN I OP, 

CRAY 

STATION 

CONC 

ENDCONC 

START 

CONFIG 

TRACE 

HPLOAD 
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CRAY 

INITIALIZES THE INTERFACE BETWEEN THE IOS AND THE CPU, 

THIS IS NECESSARY BEFORE MESSAGES CAN BE 
EXCHANGED. 

PERFORMED IMPLICITLY BY CONC AND START COMMANDS, 



STATION [,num 



J 



INITIALIZES THE IOS STATION AT CONSOLE 
num. num=0, 1,2,3 

IF num NOT SPECIFIED, A DEFAULT CONSOLE IS USED, 

CONC ",ch" 

INITIALIZES A CONCENTRATOR FOR THE FRONT-END CHANNEL 
PAIR IDENTIFIED BY ch.ch=0,l,2. 

IF Ch NOT SPECIFIED, IS USED. 

ENDCQNC £chj 

TERMINATES CONCENTRATOR ch. 

IF ch NOT SPECIFIED, IS USED, 
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START T MT(j):n, [", SV/sysdsnJ L J MT(j) : n 2 [ SV/pardsn J C 
(sysdsn J / pardsn J 

DEADSTARTS THE CPU ACCORDING TO SPECIFIED COS 
BINARY FILE (sysdsn) AND PARAMETER FILE (pardsn), 

IF DEADSTART IS FROM TAPE, THE FILES MAY BE SAVED 
IN THE COS AND PAR DIRECTORIES ON DISK. 

REFER TO CHAPTER 5 FOR A DETAILED DISCUSSION OF 
DEADSTART, 

CONFI G 

DISPLAYS RESOURCES AND CHANNEL CONFIGURATION 
INFORMATION AT THE KERNEL CONSOLE, 

MAY BE DONE AT ANY I OP KERNEL CONSOLE. 

TRACE command 

ALLOWS OPERATOR TO SELECTIVELY ENABLE/DISABLE 
SELECTED EVENTS, AND TO PRINT OUT LOCAL AND BUFFER 
MEMORY TRACE BUFFERS. 

MAY BE DONE AT ANY I OP KERNEL CONSOLE. 

REFER TO CHAPTER 6 FOR A DETAILED DISCUSSION OF THE 
COMMANDS . 

HPLQAD fn 

LOADS HEADER PAGE DATA FROM TAPE FILE NUMBER fn. 



3,4 



CHAPTER 4 
I OS STATION COMMANDS 



STATION COMMANDS ARE ENTERED AT A DEDICATED STATION CONSOLE. 

TERMINATE EACH COMMAND WITH THE RETURN KEY. 

THE STATION PROCESSES EACH COMMAND AS IT IS ENTERED AND 
INDICATES COMPLETION BY DISPLAYING THE > PROMPT CHARACTER. 

NORMALLY, STATION COMMANDS ARE DISPLAYED ON THE LOWER THREE 
LINES OF THE DISPLAY. 

ALL BUT THREE OF THE REMAINING LINES 

ARE USED TO DISPLAY REQUESTED INFORMATION. 



LINE 
1 

.2 
3 



20 
21 
22 
23 
24 



CRAY-I S STATION, _VERS I ON_Lxx 

STATION MESSAGES 



> 
> 

> 



DISPLAY AREA 



COMMAND/ RESPONSE AREA 



FIGURE 4-1. STATION DISPLAY FORMAT 
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KEY 


FUNCTION 


RETURN 
RUBOUT 
CONTROL-U 
+ OR > 

- OR < 

ESC 
CONTROL-A 

CONTROL-X 


INITIATES THE COMMAND, 

BACKSPACES AND ERASES ONE CHARACTER ON THE LINE. 

DELETES THE ENTIRE LINE. 

ROLLS DISPLAY FORWARD ONE FRAME IF ENTERED 
AS FIRST CHARACTER OF A LINE. 

ROLLS DISPLAY BACKWARD ONE FRAME IF ENTERED 
AS FIRST CHARACTER OF A LINE. 

DISCARDS UNPROCESSED KEYBOARD INPUT AND 
REFRESHES THE ENTIRE SCREEN. 

RECALLS PREVIOUS COMMAND, EDITED BY ANY 
SUBSEQUENT KEYBOARD INPUT, AND POSITIONS 
THE CURSOR AT THE END OF THE COMMAND. 

EQUIVALENT TO CONTROL-A AND A RETURN. 



TABLE 4-1. IOS STATION SPECIAL KEYS 
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STATION COMMANDS CAN BE CLASSIFIED AS THREE BASIC TYPES: 

BATCH ENTRY COMMANDS 
OPERATOR STATION COMMANDS 
DISPLAY AND STATUS RESPONSE COMMANDS 



Command 


Function 


Station 


software activation 




LOGON 




Establishes communications between a I/O 
Subsystem station and the CRAY-1 CPU 


LOGOFF 




Terminates communications between a I/O 
Subsystem station and the CRAY-1 CPU 


Staging 


control 




STAGE 




Halts or resumes staging of datasets between 

CRAY-1. CPU and the I/O Subsystem 
Station • 


SUBMIT 




Queues file for staging to CRAY-1 mass 
storage where dataset will be entered into 
job input queue 


SAVE 




Queues a file to CRAY-1 mass storage where 
it will be made a permanent dataset 


Miscellaneous control 




SNAP 




Copies display screen image to a line printer 


END 




Terminates console operation 


DELAY 




Suspends processing of a command for a 
specified time interval 


CONSOLE 




Adds another MIOP console to the Station 
software 


POLL 




Sets the rate at which control messages are 
exchanged with the CRAY-1 CPU 


SET 




Modifies the default value associated with 
an operator station's ID and TID parameters 



~~ TABLE 4-2. BATCH ENTRY COMMAND SUMMARY 
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Command 


Function 


Job control 




LIMIT 


Sets maximum number of jobs'that CRAY-1 CPU can 




process at one time 


DROP 


Ends processing of job at CRAY-1 CPU immediately 




but does not delete output datasets 


KILL 


Depending upon the job's status, either deletes 




job's input dataset from input queue or deletes 




output dataset 


RERUN 


Ends processing of job at CRAY-1 CPU immediately 




and attempts to rerun the job 


SUSPEND 


Suspends processing of one or all jobs 


RESUME 


Reschedules processing of jobs suspended by 




SUSPEND or SHUTDOWN commands 


SHUTDOWN 


Idles down job activity in preparation for a 




system interruption 


RECOVER 


Lifts suspension from jobs suspended by a 




SHUTDOWN or system interruption 


ENTER 


Assigns a new time limit or priority to a job (or 




its output dataset) ; changes ID for the station 




at which the job originated or to which its 




output dataset is to be sent, or changes its 




class assignment if it is in the input queue 


CLASS 


Turns job class or classes on or off 


MESSAGE 


Enters message into a job logfile, the system 




logfile, or both 


SWITCH 


Sets or clears a job sense switch 


Link Control 




ROUTE 


Changes the station ID for all jobs and output 




datasets having a specific ID to a new ID 


OPERATOR 


Changes the ID of the System Operator Station 


STREAM 


Changes the input, output, and active stream 




counts for the specified operator station 



TABLE 4-3. OPERATOR STATION COMMAND SUMMARY 
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Command 


Function 


Channel control 

CHANNEL 

Mass storage control 

DEVICE 


Turns CPU I/O channel on or off 

Sets or clears read-only mode for CRAY-1 mass 
storage device 



TABLE 4-3. OPERATOR STATION COMMAND SUMMARY (CONTINUED) 



Command 


Function 


CLEAR 

COMMENT 

SCROLL 

REFRESH 

JOB 

STATUS 

DATASET 

LINK 

STATION 

STORAGE 

ERROR 


Clears display area of screen 

Inserts comment in command stream 

Causes entire display area to be used as 
command/response area 

Sets display refresh rate 

Displays status of a specific job 

Displays status of all jobs in job input queue, 
all datasets in output staging queue, and all 
executing jobs 

Responds with status of specific dataset 

Displays status of station link 

Displays status of station 

Displays status of mass storage devices 

Displays information from the Error Log Table 
when errors are sensed 



TABLE 4-4. DISPLAY AND STATUS RESPONSE COMMAND SUMMARY 
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CHAPTER 5 
DEADSTART 



OVERVIEW 



IOS IS INITIALLY DEADSTARTED FROM TAPE. 



SUBSEQUENT RESTARTS MAY BE FROM DISK. 



THE CPU IS INITIALLY DEADSTARTED BY THE IOS FROM TAPE. 



SUBSEQUENT DEADSTARTS AND RESTARTS MAY BE FROM 
DISK. 
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I/O SUBSYSTEM DEADSTART 

TAPE DEADSTART: 

THE CONVENTIONAL IOS TAPE LAYOUT IS: 

FILE - TAPELOAD 

FILE 1 - DMP 

FILE 2 - KERNEL 

FILE 3 - OVERLAYS 

PROCEDURE: 

1. MOUNT THE IOS DEADSTART TAPE ON THE IOS TAPE UNIT 

2. PUSH MASTER CLEAR AND DEADSTART BUTTONS AT THE POWER 
UNIT. 

3. TYPE "2" IN RESPONSE TO THE TAPELOAD "FROM MTO:" 
MESSAGE AT THE MIOP KERNEL CONSOLE, 

4. IF THE KERNEL WAS ASSEMBLED WITH THE ON-LINE DEBUGGER, 
TYPE "X" WHEN THE ! PROMPT CHARACTER APPEARS, 

5. WHEN DEADSTART IS COMPLETE, A SYSTEM MESSAGE WILL 
BE POSTED AT EACH KERNEL CONSOLE. 

6. DEADSTART THE CPU, IF APPROPRIATE. 
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DISK DEADSTART: 



UNDER CERTAIN CONDITIONS, THE IOS MAY BE RESTARTED 
FROM A FILE IN THE IOS DIRECTORY ON DISK. 

PREREQUISITE: 

A FILE, i OS, HAS PREVIOUSLY BEEN SAVED WITH 
THE COPY FILE UTILITY, 

PROCEDURE: 

1. TYPE CNTRL-D AT THE MIOP KERNEL CONSOLE. 

IF "SYSDUMP?" APPEARS, GO TO 5. 

2. IF NO RESPONSE, MAKE SURE THERE IS NO TAPE 
LOADED ON THE TAPE DRIVE AND PUSH MASTER CLEAR 
AND DEADSTART AT THE POWER UNIT. 

3. IF 2 RESULTS IN ENTERING THE DEBUGGER, TYPE 
CNTRL-D TO EXIT. 

4. TYPE CNTRL-D AGAIN. IF "SYSDUMP?" DOES NOT 
APPEAR, A TAPE DEADSTART MUST BE PERFORMED. 

5. TYPE "Y" OR "N" IN RESPONSE TO "SYSDUMP". 

6. WHEN DUMP COMPLETE (OR IMMEDIATELY) /'RESTART?" 
WILL BE POSTED. TYPE "Y". 

7. ENTER ios IN RESPONSE TO "ENTER RESTART FILE 
NAME:" MESSAGE 

8. IF AN ERROR OCCURS, IT MAY BE NECESSARY TO DEADSTART 
FROM TAPE. 
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MESSAGE 


MEANING 


DISK ERROR 


AN UNRECOVERABLE DISK ERROR OCCURRED. 


LABEL NOT FOUND 


MASTER DEVICE LABEL COULD NOT BE FOUND, 


DIRECTORY NOT FOUND 


THE IOS DIRECTORY COULD NOT BE FOUND. 


FILE NOT FOUND 


THE NAMED FILE COULD NOT BE FOUND IN 




IOS DIRECTORY. 


MOS ERROR 


AN UNRECOVERABLE ERROR OCCURRED WHILE 




READING BUFFER MEMORY. 


RETRY? 


DISPLAYED AFTER ERROR MESSAGES. ENTER 




"Y" IF ANOTHER TRY AT RESTART IS DESIRED. 




A NEW PROMPT FOR FILE NAME WILL ALSO 




BE DISPLAYED. 



TABLE 5-1, IOS DISK RESTART ERROR MESSAGES 
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CPU DEADSTART 

CPU DEADSTART REQUIRES A COS BINARY FILE AND A PARAMETER FILE. 

EITHER OF THESE CAN RESIDE ON TAPE OR DISK. 

THE PARAMETER FILE MAY ALSO BE INPUT FROM 
THE CONSOLE; OR AM EXISTING ONE MAY BE 
EDITED THROUGH THE CONSOLE. 

THE FORMAT OF THE START COMMAND, INPUT AT THE MIOP KERNEL 
CONSOLE IS: 

START cosfile parfileC.EDU 

WHERE cosfile IS: r 

MTO:n, [,SV/sysdsnJ 

n|lS TAPE FILE NUMBER. 

SVsdsn IS DESIRED NAME OF SAVED FILE 



sysdsn - NAME OF FILE IN COS DIRECTORY 
ON DISK. 



parfile IS: - 

MTO:n 9 L SV/pardsnl 
ni IS TAPE FILE 



NUMBER, 
pardsn IS DESIRED NAME OF SAVED FILE 

pardsn - NAME OF FILE IN PAR DIRECTORY 
ON DISK. 

TTI - PARAMETER FILE IS INPUT FROM CONSOLE 
ED INDICATES PARAMETER FILE IS TO BE EDITED FIRST. 
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START EXAMPLES 
START MTO: MTO: 3 

- COS BINARY ON TAPE FILE 0; PARAMETER FILE 
ON TAPE FILE 3. 

START MTO:0, SV/C0S1 MTO: 2, SV/PAR1 

- STARTUP FROM TAPE FILES AND 2; SAVE COS 
BINARY FILE IN COS DIRECTORY AS C0S1; SAVE 
PARAMETER FILE IN PAR DIRECTORY AS PARI. 

START C0S1 PARI, ED 

- STARTUP FROM DISK FILE C0S1 WITH PARAMETER 
FILE PARI BEING EDITED FIRST, 

START MTO: 2 TTI 

- STARTUP FROM TAPE FILE 2 WITH PARAMETER 
FILE ENTERED AT CONSOLE. 
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DEADSTART DISK FILES 

THREE DISK DIRECTORIES ARE SET ASIDE BY COS AT INSTALL TIME 
FOR DEADSTART FILES. 

THE DIRECTORIES ARE: 

COS USED TO STORE COS BINARY FILES. THE 

FILES ARE CREATED, NAMED AND SAVED USING 
THE SV OPTION ON THE START COMMAND OR THE 
COPY UTILITY. 



PAR USED TO STORE PARAMETER TEXT FILES. 

THESE ARE CREATED USING THE SV OPTION ON 
THE START COMMAND; THE COPY UTILITY; AND 
THE PARAMETER FILE EDITOR. 



I OS USED TO STORE I OS BINARY FILES. THESE 
ARE CREATED USING THE COPY UTILITY. 



THE NAMES OF FILES RESIDING IN THESE DIRECTORIES MUST BE 15 
OR LESS ASCII CHARACTERS. 

THEY CANNOT BEGIN WITH MT OR TT. 
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FILE UTILITIES 

THERE ARE SEVEN UTILITIES AVAILABLE FOR MANIPULATING FILES 
IN THE COS, PAR AND IOS DIRECTORIES, 



1. EDIT fn 

INVOKES THE PARAMETER FILE EDITOR. 

fn MAY BE THE NAME OF A FILE ALREADY IN 
THE PAR DIRECTORY; OR HI, IF A NEW FILE 
IS TO BE CREATED. 

2, COPY fn-L fn 2 

COPY FILE fn x TO FILE fn 2 . THE COPY IS EITHER 
FROM TAPE TO DISK OR DISK TO TAPE. IF COPY IS 
FROM TAPE TO DISK, fn 2 CANNOT ALREADY BE IN USE 
IN THE SPECIFIED DIRECTORY. 

DISK FILES ARE DENOTED AS 'DIR'/fn, WHERE 'DIR' 
IS COS, PAR OR IOS. 

WHEN COPYING TO THE IOS DIRECTORY, THE OVERLAY 
FILE MUST IMMEDIATELY FOLLOW THE KERNEL FILE. WHEN 
COPYING THE OTHER WAY, ALLOW TWO C08SECUT I VE TAPE 
FILES ♦ 



3. FSTAT 'DIR' [/^^..J 



DISPLAY FILE STATUS (CREATED, WORD LENGTH) OF ONE OR 
MORE FILES WITHIN THE SPECIFIED DIRECTORY. 

IF NO FILE NAMES SPECIFIED, THEN STATUS OF ALL FILES 
IN THE DIRECTORY WILL BE DISPLAYED. 
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4. PURGE 'DIRVfnp... 

DELETE THE SPECIFIED FILES FROM THE 
SPECIFIED DIRECTORY. 

5. CLEAR 'DIR' 

DELETE ALL FILES FROM THE NAMED DIRECTORY. 

6. FDUMP MTO;Y 'DIR' Q/fnp . .7] 

EXECUTE A FORMATTED DUMP OF THE SPECIFIED 
FILES TO TAPE FILE Y. 

IF NO FILE NAMES SPECIFIED, ALL FILES IN 
THE DIRECTORY WILL BE DUMPED. 

7. FLOAD MTO:Y Pfrip f x\ v . . H 

LOAD A PREVIOUSLY 'FDUMPED' TAPE FILE INTO 
THE ORIGINAL DIRECTORY. 

IF NO FILE NAMES SPECIFIED, ALL FILES ON THE 
TAPE WILL BE LOADED. 

IF A FILE ALREADY EXISTS IN THE DIRECTORY, 
THE FILE ON TAPE WILL NOT BE LOADED. 

FDUMP AND FLOAD ARE USEFUL WHEN A DIRECTORY GETS 
FRAGMENTED . 
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PARAMETER FILE EDITOR 

PROVIDES FOR CREATION AND MODIFICATION OF PARAMETER TEXT 
FILES REQUIRED FOR CPU DEADSTART. 



THE EDITOR IS RUN THROUGH THE MIOP KERNEL CONSOLE. 

EACH OF THE FOLLOWING WILL INVOKE THE EDITOR: 

1. ED OPTION ON THE START COMMAND. 

2. SPECIFYING TTI FOR parfile ON THE 
START COMMAND. 

3. EDIT fn. 

THE EDITOR OPERATES IN TWO MODES: 

1. COMMAND INPUT MODE. 

THIS MODE IS RECOGNIZED BY A '? ' IN 
COLUMN 1. 

2. TEXT INPUT MODE. 

INDICATED BY A LINE NUMBER IN COLUMN 1 

INPUT IS ACCEPTED ON A LINE-BY-LINE BASIS. 
TERMINATE LINES BY CARRIAGE RETURNS OR LINE FEEDS. 
THE ESC KEY RETURNS CONTROL TO COMMAND INPUT MODE. 
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EDITOR COMMANDS 

THERE ARE SEVEN COMMANDS AVAILABLE FOR EDITING PARAMETER 
TEXT FILES. 

1. INSERT In 

INSERT TEXT FOLLOWING THE SPECIFIED LINE 
NUMBER. 

2 . APPEND 

APPEND TEXT TO THE FILE. 

IF FILE IS EMPTY, TEXT WILL BE ACCEPTED 
STARTING AT LINE 1. 

3. DELETE ln x ln 2 

DELETE LINES lr^ TO ln 2 INCLUSIVE. 

4. REPLACE ln x ln 2 

REPLACE LINES ln x TC ln 2 j INCLUSIVE, WITH 
TEXT TO BE INPUT. 

5. IYPE ln 1 ln 2 

TYPE LINES ln x TO ln 2 , INCLUSIVE, TO THE CONSOLE 
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6. PRINT ln x ln 2 



PRINT LINES ln 2 TO ln 2 , INCLUSIVE, ON THE 
PRINTER. 



7, BYE 



TERMINATE THE EDITOR. 



THE FOLLOWING MESSAGE IS DISPLAYED: 

"SAVE?" 

NO - EDITED VERSION IS DISCARDED. IF 

EDITOR WAS CALLED FROM START, EDITED 
VERSION WILL BE SENT TO CPU BUT NOT 
MADE PERMANENT. 

YES- "ENTER FILE NAME:" MESSAGE IS DISPLAYED. 
EDITED VERSION OF THE FILE WILL BE SAVED 
IN THE PAR DIRECTORY UNDER THE SPECIFIED 
NAME. 
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MESSAGE 


MEANING 


COMMAND SYNTAX ERROR 


THE COMMAND ENTERED WAS NOT IN LEGAL FORMAT 


EXPANDER DEVICE ERROR 


AN ERROR WAS ENCOUNTERED ON THE EXPANDER 




DEVICE BEING USED, 


MOS NOT AVAILABLE 


BUFFER MEMORY SPACE NOT AVAILABLE. 


LOCAL MEMORY NOT 


LOCAL MEMORY NOT AVAILABLE. 


AVAILABLE 




DISK ERROR 


AN UNRECOVERABLE DISK ERROR OCCURRED. 


FILE NOT FOUND '/NAME' 


THE SPECIFIED FILE COULD NOT BE FOUND IN THE 




CURRENT DIRECTORY. 


LABEL NOT FOUND 


THE LABEL ON THE MASTER DEVICE COULD NOT 




BE FOUND. 


FILE DIRECTORY FULL 


NO MORE ROOM IN THE CURRENT DIRECTORY FOR 




NEW FILES. 


FILE BUFFERS DEPLETED 


NOT ENOUGH DISK SPACE REMAINS IN THE CURRENT 




DIRECTORY TO LOAD THE FILE, 


FILE DELETED; 'NAME' 


FILE NAMED WAS DELETED FROM THE CURRENT 




DIRECTORY. 


FILE CREATED: 7 NAME' 


FILE NAME WAS CREATED IN THE CURRENT DIRECTOR 


FILE ALREADY EXISTS: 


THE NAMED FILE ALREADY EXISTS. IT MUST BE 


'NAME' 


PURGED BEFORE IT CAN BE RE-CREATED. 


FILE BEING UPDATED: 'NAME' 


NAMED FILE IS BEING WRITTEN OVER, 


FILE DUMPED: 'NAME' 


NAMED FILE HAS BEEN DUMPED TO THE TAPE FILE. 


FILE LOADED: 'NAME' 


NAMED FILE HAS BEEN LOADED FROM THE DUMP TAPE 




AND CREATED IN THE CURRENT DIRECTORY, 



TABLE 5-2. START COMMAND AND FILE UTILITY MESSAGES 

5.17 



PARAMETER FILES 

A PARAMETER FILE IS A TEXT FILE USED BY COS AT STARTUP 
TIME TO DETERMINE THE STARTUP MODE, DEVICE FLAWS AND 
STATUS, AND OTHER PERTINENT INFORMATION. 

A PARAMETER FILE CONSISTS OF A SET OF DIRECTIVES, EACH OF 
WHICH CONSISTS OF An *, A KEYWORD, AND ANY NECESSARY ARGUMENTS. 

ARGUMENTS AND THE KEYWORD ARE SEPARATED BY COMMAS. 

EXCEPT WHEN ENTERING ASCII DATA INTO MEMORY, A 
BLANK INDICATES THE START OF THE COMMENT FIELD. 

THERE ARE DIRECTIVES FOR: 

SELECTING A STARTUP MODE 

ENTERING MEMORY 

SETTING STARTUP BREAKPOINTS 

SETTING CENTRAL MEMORY SIZE 

CONTROL DEVICE ALLOCATION AND AVAILABILITY 

SPECIFYING DISK FLAWS 

CONTROLLING STARTUP DUMP PROCESSING 

RECOVERING ROLLED JOBS AFTER A RESTART 

CONTROLLING PERMANENT DATASET AND SYSTEM DIRECTORY RECOVERY 

INVOKING A NEW JOB CLASS STRUCTURE 

STARTING A SYSTEM FROM A CPU LOCAL DISK 
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PARAMETER FILE DIRECTIVES 

ONLY THOSE DIRECTIVES MOST LIKELY TO BE USED BY AN OPERATOR 
WILL BE DISCUSSED HERE. 

STARTUP MODE DIRECTIVES: 

THERE ARE THREE MUTUALLY EXCLUSIVE STARTUP 
MODE DIRECTIVES. 

THE LAST ONE IN THE FILE IS USED. 
* INSTALL 

STARTS COS AS FOR THE FIRST TIME. 

ALL MASS STORAGE IS ASSUMED TO BE VACANT. 

THE DATASET CATALOG (DSC) AND DEVICE LABELS ARE INTIALIZED. 

SHOULD BE USED ONLY AFTER A MAJOR SYSTEM CRASH. 
*DEADSTART 

STARTS COS AS IF AFTER A NORMAL SYSTEM TERMINATION. 
"RESTART 

STARTS COS AS IF AFTER A NORMAL SYSTEM INTERRUPTION. 

ALLOWS RECOVERY OF JOBS RUNNING WHEN SYSTEM WAS INTERRUPTED. 
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* END DIRECTIVE 

SIGNALS THE END OF THE PARAMETER FILE. 
IT IS A REQUIRED DIRECTIVE. 

* MEMSIZ, size DIRECTIVE 

OVERIDES THE I3MEM INSTALLATION PARAMETER. 

Size IS IN OCTAL WORDS AND MUST NOT EXCEED iaMEM, 

* RRJ, n DIRECTIVE 

THIS DIRECTIVE ALLOWS RECOVERY OF JOBS AFTER A RESTART. 

IF n=l, RECOVERY IS ATTEMPTED. IF n=0, NO RECOVERY 
IS ATTEMPTED. 

* LOCK, n DIRECTIVE 

TELLS COS HOW TO HANDLE JOBS WITH A NON-ZERO JTEPC 
FIELD, BEING RECOVERED IF NEW SYSTEM IS DIFFERENT FROM 
PREVIOUS ONE. 

IF n=l, RECOVER JOB WHEN THE JOB'S ORIGINAL SYSTEM IS 
DEADSTARTED. (IT COULD BE ON THIS DEADSTART ATTEMPT,) 



* J CLASS, pdn Qid j7ed]J 



ALLOWS OPERATOR TO INVOKE A NEW JOB CLASS STRUCTURE 
AFTER A DEADSTART OR RESTART. 

Pdn - NAME OF PERMANENT DATASET CONTAINING THE JOB 
CLASS STRUCTURE DEFINITION. 

id - USER ID OF THE PERMANENT DATASET 

ed - EDITION NUMBER 
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DEVICE DIRECTIVES: 

DEVICE ALLOCATION CONTROL 

* ON, ldv-^ ldv 2 ; . .., ldv n 

DECLARES A DEVICE ALLOCATABLE 
IdVj - A LOGICAL DEVICE 

* OFF, ldvp ldv 2 , . . .,ldv n 

DECLARES A DEVICE NON-ALLOCATABLE 

ldv t - A LOGICAL DEVICE 

IF BOTH *ON AND *OFF REFERENCE THE SAME DEVICE, THE 
LAST DIRECTIVE IS USED. 

THE MASTER DEVICE MAY NOT BE REFERENCED BY *OFF. 
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DEVICE AVAILABILITY CONTROL 
*DOWN, ldvp ldv 2 > . ..,ldv n 

DECLARES A DEVICE UNAVAILABLE. 

THE MASTER DEVICE MAY NOT BE REFERENCED BY THIS DIRECTIVE. 

IdVj - A LOGICAL DEVICE 

"RELEASE, ldVp ldv 2 , .... ldv n 

REMOVES THE DATASET ENTRIES FOR THIS DEVICE FROM 
THE DATASET CATALOG. 

THIS MAKES THEM INACCESSIBLE TO THIS SYSTEM. 

THE MASTER DEVICE MAY NOT BE REFERENCED BY THIS DIRECTIVE. 

ldv 1 - A LOGICAL DEVICE. 

*UP, ldvp ldv 2 , . ..,ldv n 

DECLARES A PREVIOUSLY UNAVAILABLE DEVICE AVAILABLE, 

THE DEVICE LABEL IS INITIALIZED. 

A *UP AFTER A *DOWN TAKES PRECEDENCE BUT A # DOWN AFTER 
A *UP IS ILLEGAL. 

THE MASTER DEVICE MAY NOT BE REFERENCED BY THIS DIRECTIVE.. 

ldVj - A LOGICAL DEVICE 
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DISK FLAW DIRECTIVES: 

TWO FLAW DIRECTIVES, *FLAW AND *ENDFLAW, DELIMIT A 
SET OF FLAW CARDS WHICH DECLARE VARIOUS TRACKS AND 
CYLINDERS OF THE SPECIFIED DISK UNAVAILABLE, 

THE FORMAT IS: 

*FLAW, ldv 
flaw cards 

*ENDFLAW 

ldv - LOGICAL DEVICE TO BE FLAWED. 

flaw cards - MAY BE ONE OR MORE OF THE FOLLOWING; 

Cnnn, FLAW ALL OF CYLINDER nnn 

Cnnn-mmm FLAW CYLINDERS nnn TO mnm 

Cnnn,Tmm FLAW TRACK mm OF CYLINDER nnn 

Cnnn,Tmm-pp FLAW TRACKS mm THROUGH pp OF CYLINDER nnn. 



THESE DIRECTIVES ARE NORMALLY USED TO ADD FLAWS ENCOUNTERED 
DURING SYSTEM OPERATION WITHOUT REQUIRING RE-ASSEMBLY OF THE 
SYSTEM. 
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EXAMPLE OF A DEADSTART PARAMETER FILE 





*DEADSTftRT 
*RRJ, 
*LOCK, 1 
*UP, DD- 
*OFF, DD 
*up, DD- 
*ON, DD- 
*UP, DD- 
*ON, DD- 
*UP, DD- 
*ON, DD- 
*DOWN, DD-13-41") 
*OFF, DD-13-41 j 
*FI_fiW, DD- 13-20 
*ENDFLW 

*FLAW, DD-2S-21- 
C0, T0- 
Cl-77 
C260, T05 
C35B, T10 
C525, T01 
C726, T01 
C1130, T10 
C1272, T04 
C1424, T05 
*ENDFLW 

*FLAW, DD-13-30 
C051,T03 
C053, T03 
C404, T00 
C406, TQ2 
C410, TB0 
C411,T10 
C414, T03 
C414, T0S 
C422, T01 
C422, T02 
C434, T02 
C522, T04 
C543, T01 
#ENDFLW 

*FLfiW, DD-13-31- 
C065, T04 
C06S, T04 
C067, T04 
CllQ, TQ4 
C521,T00- 
*ENDFLW 

*FLAW, DD- 13-40- 
C000, T00 
C0S7, T04 
*ENDFLW 

*FLF»W, DD- 13-41- 
C110, T04 
*ENDFLW 
*END 



SPECIFY DEADSTART MODE. 

DON'T RECOVER ROLLED JOBS. 

DON'T RECOVER JOBS WITH JTEPC SET IF NEW SYSTEM 

DIFFERENT. 

DECLARE DEVICES DD-19-21,30,31,40 AVAILABLE AND 

ALLOCATABLE AND WRITE DEVICE LABELS. 

DECLARE DD- 19-41 UNAVAILABLE AND UNALLOCATABLE. 

FLAW DD-29-21 
FLAW CYLINDER 0, TRACK 
FLAW CYLINDER 1 TO 77 



•FLAW DD-19-30 



FLAW DD- 19-31 



■FLAW DD- 19-40 



FLAW DD -19-41 

END OF PARAMETER FILE 
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SYSTEM STARTUP/SHUTDOWN CONSIDERATIONS 



WHEN INITIALLY STARTING COS, MAKE SURE ALL FRONT-ENDS 
ARE POWERED UP. 



IF THE DISKS WILL BE RUN THROUGH THE IOS, THE DD-19 INTER- 
LOCK SWITCH ON THE POWER UNIT MUST BE ON. 



WHEN SHUTTING DOWN THE SYSTEM, USE THE STATION SHUTDOWN 
COMMAND TO SAVE ANY JOBS WHICH MIGHT BE EXECUTING. 



WHEN RECOVERING A SYSTEM AFTER A NORMAL SHUTDOWN, USE 
THE STATION RECOVER COMMAND TO START EXECUTING INTERRUPTED 
JOBS WHERE THEY LEFT OFF. 
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SUMMARY OF DEADSTART PROCEDURE 

1. MAKE SURE CPU AMD FRONT-ENDS ARE PROPERLY POWERED UP. 

2. DEADSTART THE I/O SUBSYSTEM EITHER FROM TAPE OR DISK. 

3. USE THE START COMMAND TO DEADSTART THE CPU FROM TAPE 
OR DISK, MAKING CHANGES TO THE PARAMETER FILE WITH THE 
EDITOR, IF NECESSARY. 

4. RECOVER ANY JOBS, IF NECESSARY. 

5 IF SYSTEM WILL NOT START, CHECK ALL HARDWARE FOR FAILURE. 
(DISK FAULT) 

6. TRY TO START SYSTEM AGAIN. 

7. IF THIS DOES NOT WORK, TAKE A DUMP AND TRY AGAIN. 

8. IF IT STILL FAILS, GET A SYSTEM ANALYST. 



5.27 



CHAPTER 6 
DUMP UTILITIES 



DMP 



GIVES UNFORMATTED DUMP OF VARIOUS PARTS OF THE SYSTEM. 



IS A STAND-ALONG PROGRAM DEADSTARTED INTO MIOP. 



PRINTS OUT THE FOLLOWING REGISTERS AND MEMORIES: 
CENTRAL MEMORY 
BUFFER MEMORY 
I OP LOCAL MEMORIES 

IOP A,B,C, AND OPERAND REGISTERS AND EXIT STACK. 
LOCAL AND BUFFER MEMORY TRACE BUFFERS 

SHOULD ONLY BE USED IF SYSDUMP CANNOT BE BROUGHT UP. 



SEE APPENDIX B, IOS OPERATOR'S GUIDE SG-0051 FOR DETAILED 
OPERATION OF DMP. 
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SYSDUMP 



DUMPS SELECTED RESOURCES TO AN AREA OF DISK PRE-SELECTED 
AT INSTALL TIME, OR SPECIFIED DURING A SYSDUMP, 

THIS DUMP MAY THEN BE FORMATTED VIA FDUMP 
AND DISPOSED APPROPRIATELY. 



DISK RESTART OF THE IOS MAY BE DONE WHEN THE DUMP IS COMPLETE. 

THE FOLLOWING MEMORIES AND REGISTERS MAY BE DUMPED. 

CENTRAL MEMORY 

BUFFER MEMORY 

I OP LOCAL MEMORIES 

I OP OPERAND REGISTERS 

IOP A, B, C, E REGISTERS AND EXIT STACK 

I OP CHANNELS' BZ AND DN FLAGS 

CPU B,T,V AND VM REGISTERS 
SYSDUMP IS ENTERED BY TYPING CNTRL-D AT THE MIOP KERNEL CONSOLE. 



SEE APPENDIX B, IOS OPERATOR'S GUIDE SG-0051 FOR DETAILED 
OPERATION OF SYSDUMP. 
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TRACE DUMP 



AN ON-LINE DUMP OF THE HISTORY TRACE BUFFERS MAY BE TAKEN 
USING THE TRACE KERNEL COMMAND. 



THE LOCAL TRACE BUFFER OF THE I OP AT WHICH THE COMMAND IS 
ENTERED MAY BE DUMPED TO THE PRINTER. 



THE BUFFER MEMORY TRACE BUFFER OF EACH I OP MAY BE DUMPED 
TO THE PRINTER. 



FORMAT: 



C LOCAL ") 



TRACE DUMP < 

; MOS 



LOCAL - DUMP THIS I OP'S LOCAL MEMORY 
TRACE BUFFER. 

MOS - DUMP ALL I OP BUFFER MEMORY 
TRACE BUFFERS. 
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